================================================================================
 BROKEN MEMORIES  v1.0
 Looper de 4 pistas con efectos de textura y glitch para Critter & Guitari
 Organelle M (Pure Data)
================================================================================

CONTENIDO
  1. Qué es
  2. Instalación
  3. Ideas básicas
  4. Mapa de controles (teclado, pedal, AUX, encoder, perillas)
  5. Grabar y manejar loops
  6. La pantalla principal (página 0)
  7. Teclas de performance: glitch, congelar y salto aleatorio
  8. Efectos por loop (páginas 1 a 5 y 10)
  9. Efectos master y grabadora (páginas 6 a 9)
 10. MIDI
 11. Ahorro de CPU
 12. Consejos y solución de problemas
 13. Datos técnicos


--------------------------------------------------------------------------------
 1. QUÉ ES
--------------------------------------------------------------------------------
Broken Memories es un looper de 4 pistas estéreo cuyos loops son LIBRES: no
dependen de ningún BPM. Cada loop dura exactamente lo que mantengas pulsada la
tecla de grabar, desde unos 3 milisegundos hasta 24 segundos.

Cada loop pasa por su propia cadena de efectos pensada para texturas, ambientes
y glitch: granular, stutter aleatorio, filtro resonante, delay (con ping-pong y
cinta) y reverb estéreo. Después los 4 loops se suman en un master con filtro,
delay, reverb y un drive muy agresivo, un limitador siempre activo y una
grabadora estéreo propia.

Además tiene funciones de performance: glitch manual, congelar granos, salto
aleatorio del punto de inicio, entrada de pedal (footswitch) y control MIDI.


--------------------------------------------------------------------------------
 2. INSTALACIÓN
--------------------------------------------------------------------------------
Copia la carpeta "Broken Memories" completa a la carpeta Patches del Organelle.
No cambies los nombres de los archivos. La carpeta incluye "master recs", donde
se guardan las grabaciones del master; no la borres ni la renombres.

Todo el patch es Pure Data estándar. No necesita librerías externas.
Entrada y salida estéreo. El volumen general es la perilla Vol del Organelle.


--------------------------------------------------------------------------------
 3. IDEAS BÁSICAS
--------------------------------------------------------------------------------
* LOOP LIBRE. Grabas mientras mantienes la tecla; al soltarla el loop empieza a
  sonar de inmediato y se repite. A los 24 segundos se detiene solo.

* LOOP SELECCIONADO. Casi todo (efectos, glitch, congelar, salto) actúa sobre el
  loop seleccionado. Se elige con las teclas C#, D#, F# y G# de la octava baja.

* VENTANA (K4, página 0). Es qué parte del loop suena, del 1 % al 100 %. Con
  100 % suena entero; con 10 % suena solo un fragmento corto que se repite.

* PITCH (K3, página 0). Cambia la velocidad de lectura en semitonos enteros
  (-12 a +12). Sube o baja el tono y también la velocidad, como un disco.

* MIX = 0 SIGNIFICA EFECTO APAGADO. Todos los efectos arrancan con su Mix en 0.
  Para oír un efecto sube su Mix (K1 de su página). Un efecto apagado además no
  consume CPU (ver sección 11).

* TAKEOVER. Al cambiar de página, las perillas no mueven el valor hasta que las
  llevas al valor guardado o lo cruzas. En pantalla, una marca sobre la barra
  de cada perilla muestra dónde está la perilla física.


--------------------------------------------------------------------------------
 4. MAPA DE CONTROLES
--------------------------------------------------------------------------------
TECLADO (24 teclas, notas MIDI 60 a 83)

   Nota  Tecla   Función
   ----  -----   ------------------------------------------------------------
    60   C       Grabadora del MASTER: iniciar / detener
    61   C#      Elegir loop 1
    62   D       GLITCH manual en el loop elegido (mientras la mantienes)
    63   D#      Elegir loop 2
    64   E       GLITCH manual en los 4 loops (mientras la mantienes)
    65   F       CONGELAR granos del loop elegido (interruptor)
    66   F#      Elegir loop 3
    67   G       CONGELAR granos de los 4 loops (interruptor)
    68   G#      Elegir loop 4
    69   A       SALTO ALEATORIO del loop elegido (interruptor)
    70   A#      Play / stop del loop 1
    71   B       SALTO ALEATORIO de los 4 loops (interruptor)
    72   C       Ganancia de la grabación del master (cambia de paso)
    73   C#      Play / stop del loop 2
    74   D       (libre)
    75   D#      Play / stop del loop 3
    76   E       (libre)
    77   F       (libre)
    78   F#      Play / stop del loop 4
    79   G       (libre)
    80   G#      GRABAR el loop elegido (mientras la mantienes)
    81   A       (libre)
    82   A#      GRABAR los 4 loops (mientras la mantienes)
    83   B       BORRAR el loop elegido  |  AUX + B: borrar los 4

PEDAL (footswitch del Organelle)
   Pedal:         graba el loop elegido mientras lo mantienes (igual que G#).
   AUX + pedal:   graba los 4 loops a la vez (igual que A#).

AUX
   Tocar y soltar: activa o desactiva el monitoreo de la entrada. El monitoreo
   arranca activado. Si usas AUX junto con otra tecla o el pedal, al soltarlo
   NO cambia el monitoreo.

ENCODER
   Girar:      cambia de página (0 a 10; desde la 0, girar a la izquierda va
               a la 10).
   Click:      vuelve a la página 0.
   Mantener 1,5 s: sale al menú del Organelle.

PERILLAS (K1 a K4): cambian según la página (ver secciones 6 y 8).


--------------------------------------------------------------------------------
 5. GRABAR Y MANEJAR LOOPS
--------------------------------------------------------------------------------
GRABAR UN LOOP
  1. Elige el loop con C#, D#, F# o G# (loops 1 a 4).
  2. Mantén G# (octava alta, nota 80) o el pedal. Mientras lo mantienes grabas.
  3. Suelta: el loop suena. Su duración es el tiempo que lo mantuviste (de unos
     3 ms a 24 s; a los 24 s se corta solo).

GRABAR LOS 4 A LA VEZ
  Mantén A# (nota 82), o AUX + pedal. Los 4 loops graban lo mismo a la vez.

PLAY / STOP
  Teclas 70, 73, 75 y 78 (A# de la octava baja; C#, D# y F# de la octava alta)
  = loops 1, 2, 3 y 4.

BORRAR
  B (nota 83) borra el loop elegido. AUX + B borra los 4. Al borrar un loop
  también se sueltan su congelado, su glitch y su salto aleatorio.

VOLUMEN Y PANEO (página 0)
  La ganancia de cada loop es 2 x vol x vol, así que el control es suave abajo y
  generoso arriba. Un limitador siempre activo protege el master.


--------------------------------------------------------------------------------
 6. LA PANTALLA PRINCIPAL (PÁGINA 0)
--------------------------------------------------------------------------------
PERILLAS EN LA PÁGINA 0
   K1  Volumen del loop elegido
   K2  Paneo (C = centro, L1 a L50, R1 a R50)
   K3  Pitch (-12 a +12 semitonos)
   K4  Ventana (1 % a 100 %)

IZQUIERDA: una fila por loop
   Número del loop (el elegido aparece enmarcado), un icono de estado
   (raya = vacío, cuadrado = detenido, triángulo = sonando, círculo = grabando)
   y una barra de posición dentro del loop (al grabar muestra el tiempo
   grabado).
   Junto al número pueden aparecer letras:
      F = granos congelados      G = glitch manual activo
      R = salto aleatorio activo

DERECHA (una fila por línea)
   Len / Rec     Duración del loop (Len) o tiempo que llevas grabando (Rec)
   REC m:ss      Tiempo de la grabadora del master mientras graba; cuando no
                 graba muestra la ganancia de grabación (RecG +12dB)
   Sel Loop      Loop elegido
   Vol           Volumen del loop elegido
   Pan           Paneo
   Pit           Pitch en semitonos
   Win           Ventana en %
   Mon           Monitoreo de la entrada (ON / OFF)


--------------------------------------------------------------------------------
 7. TECLAS DE PERFORMANCE
--------------------------------------------------------------------------------
GLITCH MANUAL  (D = loop elegido, E = los 4; mientras las mantienes)
  El loop repite un fragmento corto de sí mismo mientras mantienes la tecla,
  aunque el Mix de GLITCH esté en 0. Usa Slice y Chaos de la página 2. Al soltar
  vuelve a sonar normal.

CONGELAR GRANOS  (F = loop elegido, G = los 4; interruptor)
  Una pulsación congela, la siguiente suelta. La nube de granos se queda fija en
  la posición del loop en que la congelaste, y se oye aunque el Mix de GRAIN
  esté en 0 (se oye la nube en lugar del loop). Usa Size, Dens y Scat de la
  página 1. Puedes cambiar esos parámetros mientras está congelado.

SALTO ALEATORIO  (A = loop elegido, B = los 4; interruptor)
  Mientras está activo, el loop cambia al azar, cada cierto tiempo:
     - su PUNTO DE INICIO (cualquier lugar de la grabación), y
     - el LARGO DE LA VENTANA (entre un mínimo que tú eliges y el valor de K4).
  El tiempo entre saltos también es aleatorio y se ajusta en la página 10
  (de 50 ms a 5 s). El primer salto ocurre al instante, para que notes que se
  activó. Cada salto baja la ganancia 4 ms y la sube de nuevo para evitar clics.
  Si detienes el loop no salta, pero sigue activado y retoma al reanudar. Al
  apagarlo, o al borrar el loop, vuelve al inicio y a la ventana de K4.
  Los granos y el glitch de ese loop siguen el nuevo punto de inicio.


--------------------------------------------------------------------------------
 8. EFECTOS POR LOOP (páginas 1 a 5 y 10)
--------------------------------------------------------------------------------
Los ajustes de estas páginas pertenecen al loop elegido: cada loop tiene los
suyos. En todas, K1 es el MIX (0 = apagado). Orden en que se aplican:
   Granular > Glitch > Filtro > Delay > Reverb > Paneo.

PÁGINA 1  GRAIN  (granular: granula el propio loop)
   K1 Mix
   K2 Size   Tamaño de cada grano, 8 a 400 ms
   K3 Dens   Densidad, 1 a 60 granos por segundo
   K4 Scat   Dispersión: cuánto varían al azar la posición y el tono de los
             granos (0 = todos iguales, 100 = muy dispersos)

PÁGINA 2  GLITCH  (stutter aleatorio)
   K1 Mix
   K2 Rate   Eventos por segundo, 0,3 a 16
   K3 Slice  Largo del fragmento que se repite, 3 a 240 ms
   K4 Chaos  Variación: largo, número de repeticiones, tono y huecos mudos
   Nota: la tecla D (glitch manual) usa Slice y Chaos de esta página.

PÁGINA 3  FILTER  (filtro resonante)
   K1 Mix
   K2 Sweep  Mitad izquierda: pasa-bajos (de 60 Hz a 18 kHz). Centro: sin filtro.
             Mitad derecha: pasa-altos (de 20 Hz a 6 kHz).
   K3 Reso   Resonancia

PÁGINA 4  DELAY
   K1 Mix
   K2 Time   Tiempo, 20 ms a 1,5 s
   K3 Fdbk   Realimentación, 0 a 95 %
   K4 Mode   Clean (limpio) | Ping (ping-pong, rebota entre L y R) |
             Tape (cinta: ondulación de tono tipo wow/flutter, saturación y
             agudos suavizados) | P+T (ping-pong y cinta)

PÁGINA 5  REVERB  (reverb de plato estéreo)
   K1 Mix
   K2 Size   Largo de la cola: de unos 1,7 s a unos 27 s (¡el máximo es muy
             largo!)
   K3 Damp   Oscurece la cola (de 14 kHz a 700 Hz)
   K4 Pre    Pre-delay, 2 a 250 ms

PÁGINA 10 JUMP  (ajustes del salto aleatorio)
   K1 Min    Intervalo mínimo entre saltos, 50 ms a 5 s
   K2 Max    Intervalo máximo entre saltos, 50 ms a 5 s
             (si Min es mayor que Max se intercambian solos)
   K3 Win    Largo MÍNIMO de la ventana, 1 % a 100 % del valor de K4.
             Con 100 % la ventana no cambia; con 10 % cada fragmento mide
             entre el 10 % y el 100 % de K4.
   Valores por defecto: Min 50 ms, Max 5 s, Win 10 %.
   (El salto se activa con las teclas A y B, ver sección 7.)


--------------------------------------------------------------------------------
 9. EFECTOS MASTER Y GRABADORA (páginas 6 a 9)
--------------------------------------------------------------------------------
Cadena del master (todo lo que suena pasa por aquí):
   Drive > Filtro > Delay > Reverb > Limitador

El limitador (techo de unos 0,9, con rodilla suave) está SIEMPRE activo y no se
muestra en pantalla.

PÁGINA 6  FILTER    igual que la página 3 (Mix, Sweep, Reso)
PÁGINA 7  DELAY     igual que la página 4 (Mix, Time, Fdbk, Mode)
PÁGINA 8  REVERB    igual que la página 5 (Mix, Size, Damp, Pre)

PÁGINA 9  DRIVE  (distorsión agresiva)
   K1 Mix
   K2 Drive  Ganancia de 1 a 2000 veces (hasta +66 dB)
   K3 Tone   Filtro de tono después de la distorsión, 600 Hz a 16 kHz
   K4 Edge   Carácter de la distorsión, en cuatro etapas:
                suave > duro > pliegue (wavefolder) > doble pliegue
             El doble pliegue vuelve a plegar la señal y genera armónicos muy
             densos.

GRABADORA DEL MASTER
   Tecla C (nota 60): iniciar / detener. Graba estéreo, 24 bits, lo mismo que
   sale por la salida (después del limitador), en la carpeta "master recs",
   como rec_001.wav, rec_002.wav, etc. La numeración continúa entre sesiones
   (el archivo counter.txt guarda el último número). En pantalla se ve REC m:ss.

   Ganancia de grabación (tecla C de la octava alta, nota 72): cada pulsación
   avanza un paso: 0, +6, +12, +18, +24 dB y vuelve a 0. Arranca en +12 dB. La
   grabación pasa por su propio limitador, así que subir la ganancia no produce
   recorte digital. No cambia lo que escuchas, solo lo que se graba. Si el
   archivo suena aplastado o saturado, baja un paso.


--------------------------------------------------------------------------------
 10. MIDI
--------------------------------------------------------------------------------
En el Organelle activa Settings > MIDI Setup > Midi In: Enabled (canal Omni o el
de tu controlador).

NOTAS 60 A 83
  Las notas MIDI entrantes se mezclan con las teclas del Organelle: una nota
  con velocidad mayor que 0 es "tecla pulsada" y velocidad 0 (o note-off) es
  "soltada". Las funciones de mantener (grabar, glitch) funcionan igual.

CONTROLES QUE GESTIONA EL SISTEMA DEL ORGANELLE
  CC 25 = AUX (64 o más = pulsado)   CC 64 = pedal   CC 21 a 24 = perillas K1 a K4

CC 40 A 63 = TECLAS 60 A 83 (para controladores sin notas: botones, pedaleras)
  CC 40 + n equivale a la tecla 60 + n. Valor 64 o más = pulsada, menos de 64 =
  soltada. Un valor repetido no dispara dos veces. Funciona en cualquier canal.

   CC 40  Grabadora master (C)         CC 41/43/46/48  Elegir loop 1/2/3/4
   CC 42  Glitch loop (mantener)       CC 44  Glitch los 4 (mantener)
   CC 45  Congelar loop                CC 47  Congelar los 4
   CC 49  Salto aleatorio loop         CC 51  Salto aleatorio los 4
   CC 52  Ganancia de grabación        CC 50/53/55/58  Play/stop loop 1/2/3/4
   CC 60  Grabar loop (mantener)       CC 62  Grabar los 4 (mantener)
   CC 63  Borrar (con AUX: los 4)


--------------------------------------------------------------------------------
 11. AHORRO DE CPU
--------------------------------------------------------------------------------
Los efectos pesados (granular, glitch, delay y reverb, tanto de los loops como del
master) están apagados mientras su Mix vale 0, y no gastan CPU.

   * Al subir el Mix de un efecto se enciende al instante.
   * Al bajar el Mix a 0 se apaga después de un breve tiempo de espera:
        granular y glitch: 0,1 s     reverb: 1,3 s     delay: 1,7 s
     (el delay y el reverb usan ese tiempo para vaciar su cola, de modo que al
     reactivarlos no suenen restos viejos). Si vuelves a subir el Mix antes de
     que termine, el efecto sigue encendido sin perder nada.
   * Congelar granos o el glitch manual encienden su efecto aunque el Mix sea 0.
   * Si un delay o un reverb estuvo apagado y lo reactivas, empieza vacío.

Ahorro: cerca del 72 % de los objetos de audio están en esos efectos; con todos
apagados queda activo solo el 28 %. Con un reverb por loop y el del master
encendidos queda activo el 61 %. Si activas a la vez todos los efectos de todos
los loops y del master (el peor caso) no hay ahorro: en una prueba anterior a
esta versión, con todo activo, el máximo fue de 75 % de CPU en el Organelle M.
Estas cifras son proporciones de la carga de audio, no mediciones de CPU de
esta versión.


--------------------------------------------------------------------------------
 12. CONSEJOS Y SOLUCIÓN DE PROBLEMAS
--------------------------------------------------------------------------------
* Un efecto "no suena": comprueba que su Mix (K1 en su página) no esté en 0 y
  que hayas cruzado el valor guardado de la perilla (takeover).

* El granular y el glitch leen del propio loop: necesitan un loop grabado y
  sonando.

* Reverb con Size muy alto y Mix alto puede saturar la mezcla; baja Size o el Mix.

* Si la grabación del master suena baja o aplastada, cambia la ganancia de
  grabación con la tecla C de la octava alta.

* Si la grabación del master falla o tiene cortes, revisa que "master recs"
  exista dentro de la carpeta del patch y que el Organelle tenga espacio libre.

* El monitoreo de la entrada arranca activado; apágalo con AUX si hay
  realimentación o no lo quieres.

* Para volver siempre a un punto conocido, haz click en el encoder: lleva a la
  página 0.


--------------------------------------------------------------------------------
 13. DATOS TÉCNICOS
--------------------------------------------------------------------------------
* Loops: 4 pistas estéreo, de 3 ms a 24 s, libres (sin BPM).
* Memoria: unos 38 MB para los 4 loops de 24 s.
* Grabadora del master: WAV estéreo de 24 bits, ganancia 0 a +24 dB.
* Reverb: plato estéreo tipo Dattorro, implementado en Pd estándar.
* Drive: ganancia hasta 2000 veces, 4 etapas de carácter.
* Todo es Pure Data estándar (sin externals). Probado en simulación; el
  comportamiento en el equipo depende de la versión de Pd del Organelle.

Versión 1.0
